안녕하세요, 하이스트레인저 백엔드 엔지니어 이상훈입니다.
최근 많은 IT 회사들이 기술 블로그를 도입하려는 시도가 점차 늘어나고 있습니다. 하지만 바쁜 업무 일정이나 블로그의 구축 및 운영에 필요한 리소스 투입의 어려움 등 다양한 이유로 꾸준히 회사 기술 블로그를 유지하기란 쉽지 않은 일인 것 같습니다.
저희 하이스트레인저도 새로운 기술 블로그를 개설하면서 이러한 고민들이 있었습니다. 그래서 저희가 어떻게 빠르고 간편하게 기술 블로그를 구축할 수 있었는지 여러분과 나누고자 합니다. 기술 블로그를 구축하고 운영하고자 하는 분들께 작은 도움이 되었으면 좋겠습니다.
기술 블로그 도입 배경
많은 IT 회사에서 각기 다양한 목적으로 기술 블로그를 운영하고 있습니다. 그렇다면 하이스트레인저는 어떤 맥락에서 기술 블로그를 도입하게 되었을까요?
하이스트레인저는 개인과 회사의 성장을 위해 기술 블로그를 도입하게 되었습니다.
프로젝트를 진행하다 보면 다양한 문제에 직면하게 됩니다. 그중에는 반복적으로 발생하는 문제들도 있어, 이러한 문제들을 체계적으로 정리하고 팀원들과 공유하면 업무 효율을 높일 수 있을 것 같다는 의견이 있었습니다.
저 역시 문제 해결 경험이나 새로 도입한 기술의 적용 과정 등을 정리하여 팀원과 공유한다면 그 과정 속에서 성장할 수 있을 것이라 생각하였고, 이러한 경험을 블로그에 남기면 추후 레퍼런스로 활용할 수 있기에 기술 블로그 도입에 찬성하였습니다.
회사 차원에서도 기술 블로그를 통해 회사에서 어떤 기술로 어떤 문제를 어떻게 해결하는지의 과정을 공유한다면 글을 읽는 분들이 우리 회사의 업무 방식과 기술력을 쉽게 이해할 수 있고, 회사를 알릴 수 있는 기회가 될 수 있습니다.
정리하자면, 기술 블로그를 통해 조직 구성원의 성장과 회사가 해결하는 문제 및 기술력을 공유할 수 있기에 도입하게 되었습니다.
플랫폼 및 프레임워크 선택
기술 블로그를 도입하기로 결정한 후, 어떤 플랫폼과 프레임워크를 통해 블로그를 구축할지에 대해 논의하였습니다.
플랫폼
처음 플랫폼을 선택하는 과정에서 GitHub Pages, WordPress, Velog, Medium, Tistory 등 다양한 옵션들이 있었습니다. 선택지가 많았던 만큼, 저희는 회사의 상황과 요구사항에 부합하는 핵심 포인트에 집중하여 고민하였습니다.
우선 고려한 사항은 다음과 같습니다.
구축 및 유지 비용이 저렴한가?
스타트업의 특성상, 메인 서비스가 아닌 기술 블로그에 큰 투자를 할 수 없었습니다. 따라서 구축과 유지에 많은 비용이 들지 않는지가 가장 중요한 고려 사항이었습니다.
SEO에 유리한가?
기술 블로그를 통해 회사 홍보의 목적도 있었기 때문에, 검색 엔진 최적화(SEO)에 유리한 정적 사이트 기반의 플랫폼을 선택해야 했습니다.
자유롭고 유연한 커스터마이징이 가능한가?
회사의 브랜드 이미지를 효과적으로 전달하기 위해서는 자유롭고 유연하게 커스터마이징할 수 있는 플랫폼이 필요했습니다.
위의 세 가지 기준을 토대로 여러 플랫폼을 검토한 결과, GitHub Pages와 WordPress가 최종 후보로 남게 되었습니다. 두 플랫폼 모두 비용 측면에서 효율적이고, SEO 친화적이며, 어느 정도의 커스터마이징이 가능했습니다.
하지만 마지막으로 결정적인 요소는 커스터마이징의 범위와 유연성이었습니다. GitHub Pages는 개발자가 코드 기반으로 자유롭게 커스터마이징할 수 있어, 우리만의 독특한 브랜드 이미지를 구현하는 데 더욱 적합했습니다. 반면 WordPress는 플러그인과 테마를 통해 커스터마이징할 수 있지만, 그 범위에 한계가 있었습니다.
결국, 저희는 자유롭고 유연한 커스터마이징이 가능한 GitHub Pages를 선택하여 기술 블로그를 구축하기로 결정하였습니다.
프레임워크
GitHub Pages 플랫폼을 사용하기로 결정한 후, 자연스럽게 어떤 프레임워크를 사용할 것인가에 대한 논의가 이어졌습니다. GitHub에서는 공식적으로 Jekyll을 지원하기 때문에 처음에는 Jekyll을 도입하려 했습니다. 그러나 팀원들이 Ruby에 익숙하지 않고, 환경 설정에 시간이 많이 소요된다는 단점이 있어 다른 대안을 찾기로 했습니다.
더 나은 선택지를 찾기 위해 Static Site Generators 사이트를 방문해 보니, 무려 363개의 정적 사이트 생성 프레임워크가 있었습니다.(2025/1/31 기준)
일반적으로는 공식 문서가 잘 작성되어 있고, 대중적인 레퍼런스가 많은 프레임워크를 선택하는 것이 최선입니다. 하지만 저희는 앞서 말씀드린 것처럼 큰 투자 없이 프레임워크의 템플릿을 이용해 빠르게 기술 블로그를 구축하고 운영하기를 원했습니다. 이에 따라 다음과 같은 기준을 세웠습니다:
JavaScript 기반의 프레임워크인가?
회사의 프론트엔드 스택이 React로 구성되어 있고, 저 또한 Node.js를 이용한 서버 개발 경험이 있어 JavaScript기반의 프레임워크를 선호하였습니다.다양한 레퍼런스가 존재하는가?
빠르게 블로그를 구축하기 위해 커뮤니티나 문서 등의 참고 자료가 풍부한 프레임워크를 우선순위로 선정하였습니다.다양한 템플릿이 존재하는가?
유연하고 빠른 커스터마이징을 위해 사용 가능한 템플릿이 많은 프레임워크를 선호하였습니다.
위의 기준을 바탕으로 여러 프레임워크를 검토한 결과, Hexo를 도입하기로 결정했습니다. Hexo는 JavaScript 기반의 프레임워크로, 공식 한글 문서를 지원하여 손쉽게 구축할 수 있습니다. 또한 다양한 디자인의 템플릿이 존재하여 원하는 디자인의 기술 블로그를 만들 수 있습니다.
Hexo 도입의 장점:
- JavaScript 기반으로 팀원들의 기술 스택과 일치
- 공식 한글 문서 지원으로 빠른 학습 가능
- 다양한 템플릿 제공으로 커스터마이징 용이
- 활발한 커뮤니티로 인한 풍부한 레퍼런스
구축
플랫폼과 프레임워크를 결정하고 나니, 이를 기반으로 기술 블로그를 구축하는 것은 어렵지 않았습니다.
Hexo 공식 문서를 참고하여 필요한 개발 환경을 설정하고, 마음에 드는 템플릿을 클론하여 간단한 커스터마이징을 통해 기술 블로그를 완성할 수 있었습니다.
하지만 기존의 템플릿을 커스터마이징하여 기술 블로그를 만들고자 하는 분들을 위해, 시간을 절약하고 효율적으로 작업할 수 있는 두 가지 유용한 팁을 공유하고자 합니다.
기능이 풍부한 템플릿 선택
다양한 기능을 포함한 템플릿을 선택하는 것이 개발 속도에 큰 도움이 될 수 있습니다.
기능이 제한적인 템플릿을 사용하면 원하는 기능을 직접 개발하여 추가해야 하지만, 기능이 풍부한 템플릿은 필요하지 않은 기능을 비활성화하거나 삭제하는 방식으로 쉽게 조정할 수 있습니다. 이는 개발 시간과 노력을 크게 절약해 줍니다.
만약 원하는 디자인의 템플릿이 원하는 기능을 충분히 제공하지 않는다면, 이용 방법에 대한 문서가 상세하게 작성된 템플릿을 선택하는 것이 좋습니다. 친절한 문서는 커스터마이징 과정에서 발생하는 문제를 해결하는 데 큰 도움이 됩니다.
단, 너무 많은 기능과 플러그인이 결합된 템플릿은 오히려 수정이 복잡해질 수 있으므로, 적절한 수준의 기능을 가진 템플릿을 선택하는 것이 중요합니다.
최신 템플릿 사용
최근에 업데이트된 템플릿을 사용하는 것이 버전 호환성 문제를 줄이는 데 유리합니다. 너무 오래된 템플릿은 현재의 Hexo 버전이나 최신 라이브러리와의 호환성 문제가 발생할 수 있습니다.
하이스트레인저는 hexo-theme-huweihuang 템플릿을 선택하여 블로그를 구축했는데, 이 템플릿은 마지막 업데이트가 5년 전이었습니다. 그로 인해, 여러 라이브러리의 버전 충돌이 발생해 각 버전을 수동으로 업데이트하고, 문제를 해결하는 데 예상보다 많은 시간이 소요되었습니다.
만약 꼭 사용하고 싶은 디자인의 템플릿이 오래된 것이라면, 사용하는 라이브러리가 적은 템플릿을 선택하는 것이 좋습니다. 라이브러리가 적으면 버전 관리와 커스터마이징이 더 수월해지기 때문입니다. 이렇게 하면 개발 과정에서 발생할 수 있는 호환성 문제를 최소화할 수 있습니다.
추가로, 템플릿을 선택하는 데 크게 도움이 되었던 테마 모음 사이트를 소개합니다. 이 사이트는 원하는 프레임워크나 아키텍처를 기준으로 필터링하여 검색할 수 있는 기능도 있어, 템플릿 선택에 많은 도움이 될 수 있습니다.
마치며
회사 기술 블로그를 개발하며 겪은 여러 문제들을 글로 작성하니 저 스스로도 많이 정리되는 것 같습니다. 기술 블로그의 장점을 느낄 수 있었던 기술 블로그 개발기였네요 :)
개인 블로그가 아닌 회사 블로그를 운영하시는 분들께 도움이 되었길 바랍니다. 읽어주셔서 감사합니다.
